home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
PC-SIG: World of Utilities
/
PC-SIG's World of Utilities (PC-SIG) (1994).iso
/
UTI
/
DISK0874.ZIP
/
MANUAL
< prev
next >
Wrap
Text File
|
1987-08-04
|
38KB
|
1,453 lines
ZZAP (c) 1987 David K. Lovison 1 WESTCOMP
ZZAP IS COPYRIGHT (c) 1987 DAVID K. LOVISON
ALL RIGHTS RESERVED
(References to ZZAP include ZZAPA).
You may make archival copies of ZZAP, ZZAPA and MANUAL programs for
yourself only! The low price of these programs is an incentive to pay
WESTCOMP for this software in exchange for hassle-free unprotected
software. Such a program can only survive if everyone pays their full
share. If this software is to be used at a facility with more than
one computer, please send a simple letter to WESTCOMP telling us the
company and number of units this package will be used on. You will
find our payment request will be very satisfactory in return for your
honesty.
ZZAP (c) 1987 David K. Lovison 2 WESTCOMP
T A B L E O F C O N T E N T S
CHAPTER SUBJECT PAGE
_______ ______________________________________________ ____
1.0 .... SELECTING OPTIONS AND CHANGING FIELDS ........ 3
2.0 .... ENTRY - TOP LEVEL ............................ 5
3.0 .... BUFFER OPERATIONS ............................ 6
4.0 .... CHANGING WINDOW VIEW BUFFERS ................. 9
5.0 .... EDITING IN A WINDOW VIEW ..................... 10
6.0 .... PAGE OPERATIONS .............................. 11
7.0 .... DISK INPUT TO A WINDOW VIEW .................. 15
8.0 .... OPEN A WINDOW VIEW ........................... 17
9.0 .... DISK OUTPUT FROM A WINDOW VIEW ............... 18
10.0 .... WINDOW VIEW BUFFER <-> MEMORY TRANSFERS ...... 20
11.0 .... LEAVING ZZAP ................................. 21
ZZAP (c) 1987 David K. Lovison 3 WESTCOMP
1.0 .... SELECTING OPTIONS AND CHANGING FIELDS
There are three (3) main ways to select options within ZZAP:
1 - SELECTION FROM A WINDOW MENU,
2 - SELECTION BY USING THE SPACE BAR and
3 - SELECTION BY ALPHA/NUMERIC INPUT.
1.1 .... SELECTION FROM A WINDOW MENU
If more than one (1) choice for an option appears within the bounds of
a window boarder that suddenly appears, this is a selection from a
window menu.
An example of this would be the options that appear at the top level
of ZZAP after the space bar has been depressed. (Run ZZAP (or ZZAP
B), then depress the space bar). When a window with options appear,
selection may be made by:
DEPRESSING THE FIRST LETTER OF THE OPTION
or
MOVE THE SELECTION BAR WITH THE SPACE BAR
OR CURSOR ARROW KEYS THEN DEPRESS THE ENTER KEY.
If you change your mind, you may depress the 'ESC' key and return to
the top level of ZZAP. There are numerous windows of this type and
they vary in size from that of the major options to just two (2)
options in size. They all will use the same method of selection or
abort. There is one window that appears that may look like a window
menu but it is not. This is seen when you select the PAGE OPERATIONS
option. This option has it's own window and options within that
window but changing those options are different than a window menu.
As actual parameters to be changed, they are altered by ways that are
covered in 1.2 and 1.3 (see also 6.0 .... PAGE OPERATIONS).
1.2 .... SELECTION BY USING THE SPACE BAR
Some operations (in PAGE OPERATIONS) are changed only by depressing
the space bar. These are limited to parameters that have a limited
selection of options such as the printer (ON / OFF) or the display
mode (HEX / ASC / DEC / OCT). If you are depressing the space bar and
you pass the selection you wanted, just depress the space bar again
until it re-appears. The options are displayed in a looping fashion.
1.3 .... SELECTION BY ALPHA/NUMERIC INPUT
Throughout the ZZAP program, numerous numeric and alpha fields will be
displayed in reverse video or normal video. Some requests for input
will prompt you without showing a preselected field.
ZZAP (c) 1987 David K. Lovison 4 WESTCOMP
If there is no preselected field and you depress the enter key without
any other input, this will usually be interpreted as a request to
abort whatever you are into.
If there is a preselected field that is seen (usually in reverse
video) you may use the 'DEL' key to completely erase it or the
backspace key to remove a charactor at a time.
If the field is numeric, your keystrokes are checked for the type of
numeric field being input. For example, if the field is octal, you
will not be able to enter an 8 or 9 or any other charactor that is not
within the family of octal numbers.
Alpha fields will only accept alpha charactors (such as the ABS DRIVE
in the PAGE OPERATIONS mode). Alpha numeric fields can contain most
anything. It does not mean that it is a valid field, however. Such
is the case of the file path/name. The validity is not checked until
you actually do a read or write. The same is true of the ABS DRIVE.
Any letter is allowed for it so be sure you have the drive that
matches the letter!
ZZAP (c) 1987 David K. Lovison 5 WESTCOMP
2.0 .... ENTRY - TOP LEVEL
When you first run the ZZAP program, one large window fills the screen
and a smaller window will be on the right hand side (the interface
window). This is the top level of ZZAP. The interface window is used
throughout ZZAP as an area to prompt you for input as well as
displaying some information relative to the options you are currently
in.
Note on the bottom a "status line". On entry, it shows:
GM: OFF / BUF: BUF / SEG: 0x.... /
This says that the graphics mode is off, the window view buffer is set
to the internal buffer. Because the window view buffer is set to the
internal buffer, there is no memory segment address specified.
The following keys are used at the top level:
KEY PURPOSE
_____ ________________________________________________________________
SPACE DISPLAYS OPTIONS (IF ALREADY DISPLAYED, MOVES SELECTION BAR)
ESC IF OPTIONS DISPLAYED, REMOVES THE OPTION WINDOW, ELSE
IF A WINDOW VIEW IS ACTIVE, CLOSES THAT WINDOW VIEW
B BUFFER OPERATIONS
C CHANGE BUFFER (TOGGLE BETWEEN BUFFER/MEMORY)
E EDIT THE BUFFER (THE CURRENT WINDOW VIEW)
P PAGE OPERATIONS
R READ INTO THE BUFFER
V VIEW A WINDOW
W WRITE FROM THE BUFFER
M MOVE BUFFER <-> MEMORY
Z ZZAP EXIT
F1 IF LEFT WINDOW IS UP AND NOT CURRENT, MAKES IT THE CURRENT ONE
F2 IF RIGHT WINDOW IS UP AND NOT CURRENT, MAKES IT THE CURRENT ONE
ALT-G TOGGLE BETWEEN GRAPHIC MODE ON / OFF
ZZAP (c) 1987 David K. Lovison 6 WESTCOMP
3.0 .... BUFFER OPERATIONS
This operation allows you to perform various operations to the window
view buffer (or whatever the window view is accessing). It is
necessary for a window view to be active in order to use this option.
If no window view is up,
one will be opened for you. After selecting this option, another
window with
options will be displayed. Select from:
1 - ADVANCE
2 - COPY
3 - EXCHANGE
4 - FILL
5 - SCAN
6 - MATCH
7 - NEW MODE
8 - LOGICALS
3.1 .... ADVANCE
This allows you to move the specified byte (0 - 65535) to the top of
the active window view. After the prompt "ADVANCE TO:", input the
number of the byte to move to in decimal. After you input a number,
that byte will now be at the top of the active window view. The
window view will loop back to the beginning
(byte 0) if the display reaches the end (byte 65535) first.
3.2 .... COPY
This allows you to copy a range of bytes from one area to another
within the current window view. You will be asked for three (3)
parameters:
PROMPT INPUT
__________ _____________________________________________________
SOURCE: THE BYTE # (DEC) OF THE STARTING STRING TO COPY
DESTIN: THE BYTE # (DEC) TO BEGIN TRANSFERING TO
COUNT: THE NUMBER OF BYTES TO COPY (UP TO 65535)
3.3 .... EXCHANGE
This allows you to exchange a range of bytes with one another within
the current window view. Again, you will be asked for three (3)
parameters:
PROMPT INPUT
__________ ____________________________________________________
SOURCE: THE BYTE # (DEC) OF THE STARTING STRING TO EXCHANGE
DESTIN: THE BYTE # (DEC) TO BEGIN THE EXCHANGE WITH
ZZAP (c) 1987 David K. Lovison 7 WESTCOMP
COUNT: THE NUMBER OF BYTES TO EXCHANGE (UP TO 65535)
3.4 .... FILL
This allows you to fill the current window view buffer with a selected
byte. The three (3) parameters to answer are:
PROMPT INPUT
__________ ____________________________________________________
START BYTE: THE BYTE # (DEC) TO BEGIN THE FILL
# OF BYTES: THE NUMBER OF BYTES YOU WANT TO FILL
FILL WITH: INPUT DEPENDS ON THE CURRENT MODE FOR THAT WINDOW
When ZZAP is first entered, both windows are set to an ASCii mode.
The mode is seen at the top of the window view itself - it is in
normal video while the other options are in the same video mode as the
window border itself. See 3.7 on changing this mode.
3.5 .... SCAN
This allows you to scan the current window view up or down. The
buffer will loop around if one of the limits are reached (0 or 65535).
There are no prompts
but you can use the up arrow and down arrow cursor keys to control
the direction of the scan. You can use the left and right arrow
cursor keys to control the scanning speed. The left arrow speeds the
scan. This throttle was used to adjust the speed because of the
variety of systems and their various clock speeds. Some systems,
without the throttle, will scan so fast that nothing is readable at
all - just a blurrrrrr! While you are scanning, you may pause the
display by pressing the space bar. Any other key will continue the
scan. To exit the scan mode, depress the 'END' key.
3.6 .... MATCH
This allows a string to be searched for within a window view (the
destination
window). A window menu will appear twice to prompt you for the
source and destination windows. The window view for the source /
destination must be open yet not necessarily active. The source and
destination window views can be the same window. After selection of
the source and destination, the following parameters must be answered:
PROMPT INPUT
__________ ____________________________________________________
MATCH BYTE: BYTE # OF START OF STRING IN SOURCE WINDOW (DEC)
# OF BYTES: # OF BYTES IN THE STRING TO SEARCH FOR
START SEARCH
FROM BYTE: BYTE # IN DESTINATION WINDOW TO BEGIN THE SEARCH
ZZAP (c) 1987 David K. Lovison 8 WESTCOMP
If no match is found, a message is printed to state such and the
program will pause until a key is pressed.
If a match is found, a beep will occur and the destination window top
byte is set to the 1st byte of the matched string. If the destination
window is also set as the current window, the window will be updated.
If the destination window is not the current window, you will not see
the update until you make it the current window with the F1/F2 keys at
the top level.
3.7 .... NEW MODE
This is where you select the mode (ASC, DEC, OCT, HEX) to use for the
current window. Another window of options will be displayed with the
four (4) options. Simply select the new option and the mode
indication on top of the current window will be changed!
3.8 .... LOGICALS
You can perform logical operations to a range of bytes within the
current window view. Upon selection of this option, another window
menu will appear. Select the logical operation to be performed (AND,
OR, XOR, RSH, LSH, CMP). The CMP is a one's compliment. After
selection of the operation, answer the following prompts:
PROMPT INPUT
__________ ____________________________________________________
START BYTE: STARTING BYTE # TO PERFORM OPERATION
# OF BYTES: NUMBER OF BYTES TO DO (UP TO 65535)
LOGICAL BYTE: BYTE (HEX) TO PERFORM LOGICAL OPERATION WITH
ZZAP (c) 1987 David K. Lovison 9 WESTCOMP
4.0 .... CHANGING WINDOW VIEW BUFFERS
This option will toggle between the internal window view buffer and a
specified memory segment. If a window view is current (high-lighted),
that window view will be toggled also. If the current window view is
pointing to the internal buffer and this option is selected, that
window will now change to whatever segment in memory specified. If
this option is selected again, the window will once again be back to
the internal buffer (no data is altered by using this mode). Note
that a window view does not need to be opened for this option. If
this option is selected, the next window view to be opened will be
opened into whatever is shown at the bottom status line: BUF: xxx /
SEG: 0x....
When going from the buffer to memory, you will be prompted for the
memory segment (HEX) to use as the new "buffer". When switching back
and forth between left and right window views, the bottom status line
will display what that window view is pointing to.
ZZAP (c) 1987 David K. Lovison 10 WESTCOMP
5.0 .... EDITING IN A WINDOW VIEW
You may edit the current window view a byte at a time in the current
mode for that window (HEX, DEC, OCT, ASC). You will be prompted for
"EDIT BYTE:". This is the starting byte (in DEC) to begin to edit. A
reverse video bar will be displayed over the first byte to edit.
Use the up arrow and down arrow cursor keys to move the edit bar
before
you input the next byte.
If the current mode is ASC, you may type freely until you depress ALT-
Q. This will terminate the edit session is the mode was ASC. To
terminate the edit session in a numeric mode, just depress the "ENTER"
key (no input).
Upon termination, the edit bar will leave and you will be returned to
the top level of ZZAP.
ZZAP (c) 1987 David K. Lovison 11 WESTCOMP
6.0 .... PAGE OPERATIONS
Page operations allows you to view data in one of four modes that will
fill the screen (256 bytes at a time). Upon selection of this option,
you will see the page set-up screen. These are parameters that may be
changed to suit your individual need. They are:
1 - PRINTER 9 - FILE END
2 - PAGE LENGTH 10 - SECTOR START
3 - LEFT MARGIN 11 - SECTOR END
4 - PERF SKIP 12 - ABS DRIVE
5 - FILE NAME 13 - ACCESS MODE
6 - BUFFER START 14 - SHOW BYTE CNT
7 - BUFFER END 15 - DISPLAY MODE
8 - FILE START 16 - FILE DUMP
To select a parameter to change, move the selection bar with the up
and down arrow keys.
6.1 .... PRINTER
Allows the output to be sent to the printer. Selection is toggled
with the space bar - ON / OFF.
6.2 .... PAGE LENGTH
Allows setting the number of printed lines (data only, does not
include the title line) for output to the printer. To change, depress
the space bar and change the numeric field. Depress the "ENTER" key
when you are finished. When the page length is met, the page number
is incremented (lines are counted even when scrolling up and down).
6.3 .... LEFT MARGIN
Allows a left margin to be printed before each line is printed to the
printer.
This just allows for neater outputs from the printer. Edit of this
field is done as in 6.2.
6.4 .... PERF SKIP
When the printer is ON and the number of lines printed match the page
length,
blank lines will be output (to skip over fan fold paper perfs). Edit
of this field is done as in 6.2.
6.5 .... FILE NAME
The file name (which can include a drive/path) can be up to 50
charactors in length. This file name is shared by the READ / WRITE
operations to the window view modes. Edit of this field is done as
ZZAP (c) 1987 David K. Lovison 12 WESTCOMP
mentioned in chapter 1.0.
6.6 .... BUFFER START
The starting byte (DEC) to start the page display in. When you edit
this value, you can not make it greater than the buffer end byte. If
you need to,
change the buffer end byte value first. Edit of this field is done
as in 6.2.
6.7 .... BUFFER END
The ending byte (DEC) to end the page display in. When you edit this
value,
you can not make it less than that of the buffer start byte. If you
need to,
change the buffer start value first. Edit of this field is done as
in 6.2.
6.8 .... FILE START
File start values always begin with 1. You can not make this any less
than 1 nor can you make it greater than the file end byte. If you
need to, change the file end value first. If the start value is
greater than the end of the file (the file size), you will get an
error. Edit of this field is done as in 6.2.
6.9 .... FILE END
The file end value can not be less than that of the file start value.
It can exceed the end of the file. If it does, the value will be
readjusted to a
value that will not exceed the file end as well as exceed the page
buffer (one segment in size) that is used for disk input, both file
and sector
operations. Edit of this field is done as in 6.2.
6.10 .... SECTOR START
The sector start can range up to and including the sector end value.
If both sector start and end are the same, only that sector is read
in. Edit of this field is done as in 6.2. Sectors are logical
sectors numbered from 0.
6.11 .... SECTOR END
This value can not go below the sector start value. Edit of this
field is done as in 6.2.
ZZAP (c) 1987 David K. Lovison 13 WESTCOMP
6.12 .... ABS DRIVE
This is the drive letter used for absolute (sector) operations. This
drive is the same as used for sector READ / WRITE operations to the
window view. To
edit the drive, depress the space bar, depress the backspace key and
enter a drive. If you don't enter anything, you will get an invalid
drive error.
6.13 .... ACCESS MODE
This is what the page mode will actually display. Depressing the
space bar
will cycle through the options of BUFFER, FILE, SECTOR. If file or
sector have been selected, the disk and file / sector will be accessed
and the data will be read into the dedicated file buffer (the address
of this file buffer appears at the bottom right hand side of the page
options screen. You can use this segment with the window view thus
providing a way to write back to the disk. The BUFFER selection is
the current window view buffer, whether that be the internal window
view buffer or a memory segment specified with the 'c' mode option at
the top level of ZZAP.
6.14 .... SHOW BYTE CNT
Depressing the space bar will toggle this selection between HEX and
DEC. The values on the right-hand side of the page display as well as
the start and end bytes will be displayed in whatever mode this option
is in. If the ACCESS MODE has been set to SECTOR, the byte count is
always changed to HEX to show both the sector and byte of that sector.
6.15 .... DISPLAY MODE
The actual display of data in page mode will be in this mode. Depress
the space bar to cycle through the options (DEC, HEX, OCT, ASC). When
the HEX mode is selected, the display is both HEX and ASC, with the
ASC showing only printable charactors. Any other charactors will be
displayed by a period.
6.16 .... FILE DUMP
This allows you to dump a file from the start byte specified to the
end of the file. The file end value will be reset to read in a full
segment worth of data until the end of file is reached. The ACCESS
MODE must be set to FILE.
When the dump begins, it will stop when it reaches the end of the
file or when a key is depressed. This means you can dump those large
files to a printer and walk away until it is done!
To leave the page options and display the data, just depress the 'END'
key.
ZZAP (c) 1987 David K. Lovison 14 WESTCOMP
To return to the top level, depress the 'ESC' key.
While in the page display, the following keys may be used (except if
doing a file dump):
KEY PURPOSE
_________ ________________________________________________________________
DN ARROW SCROLL THE DATA DOWN UNTIL THE END LIMIT IS REACHED
UP ARROW SCROLL THE DATA UP UNTIL THE END LIMIT IS REACHED
PGDN SCROLL THE DATA DOWN 1 PAGE WORTH
PGUP SCROLL THE DATA UP 1 PAGE WORTH
HOME START THE DISPLAY FROM THE STARTING BYTE
END START THE DISPLAY TO INCLUDE THE END BYTE
ALT-G TOGGLE THE GRAPHIC MODE DISPLAY
ALT-Q TOGGLE THE EDIT MODE
ALT-A WHEN IN HEX DISPLAY MODE AND IN EDIT MODE, TOGGLE TO/FROM ASCII
LT ARROW SPEED THE DISPLAY UP (SAME AS THROTTLE IN BUFFER SCAN MODE)
RT ARROW SLOW THE DISPLAY DOWN (SAME AS THROTTEL IN BUFFER SCAN MODE)
ESC RETURN BACK TO THE PAGE OPTIONS
When in the edit mode, use the cursor arrow keys to move the cursor.
Edit mode will edit only the data that is displayed at that point in
time!
ZZAP (c) 1987 David K. Lovison 15 WESTCOMP
7.0 .... DISK INPUT TO A WINDOW VIEW
You may read file or sector data into the current window view. Pay
attention to what the current window view is pointing to! If the
drive you are using is a removeable media drive, be sure the media is
in first!
NOTE: ZZAP RETAINED THE FATAL ERROR HANDLER OF MS-DOS. IF A FATAL ERROR
DOES OCCUR, ATTEMPT TO CORRECT THE PROBLEM (UNLESS YOU WANT TO ABORT)
AND RETRY THE OPERATION. THE WORST CASE RESULT IS THAT SMALL PORTIONS
OF THE SCREEN WILL RETAIN THE CHARACTORS THAT WERE PRINTED BY THE
FATAL ERROR ROUTINE. IT WAS DECIDED THAT IF THE ERROR WAS FATAL IN
NATURE, WE WANTED ZZAP TO RETURN TO THE OPERATING SYSTEM IN CASE OF
AN EMERGENCY ABORT.
Upon selection of this option, you will be prompted with a window
menu:
1 - FILE ACCESS
2 - SECTOR ACCESS
7.1 .... FILE ACCESS
DO NOT REMOVE YOUR DISK MEDIA UNTIL THE PROGRAM HAS RETURNED TO THE
TOP LEVEL!
In this mode, if you specify a file name that does not exists, one
will be created with a length of 0.
You will be shown the drive/path/filename (same one as in PAGE
OPERATIONS) and be given an opportunity to change it.
After depressing the "ENTER" key, the file will be accessed and the
size of file will be displayed.
PROMPT INPUT
__________ ____________________________________________________
FILE ST: >= 1, 0 WILL ABORT, ERROR IF > SIZE OF FILE
XFER CT: NUMBER OF BYTES TO TRANSFER TO THE CURRENT WINDOW
BUFF ST: STARTING BYTE OF BUFFER TO BEGIN THE TRANSFER
An error will result if the XFER CT plus the BUFF ST exceeds the end
of the window view buffer (65535). The maximum bytes that can be
transfered is 65536 when BUFF ST = 0. If the XFER CT is greater than
the end of the file, XFER CT is changed to the end of the file (the
file size).
After entering the above, "<R>ead" will appear. You must enter an 'r'
or 'R' to begin the read operation. After the read is done, you will
be told the number of bytes that actually transfered and ZZAP will
pause until you depress a key.
The current window is updated upon return to the top level.
ZZAP (c) 1987 David K. Lovison 16 WESTCOMP
7.2 .... SECTOR ACCESS
You will be shown the drive (change it in the PAGE OPERATIONS options)
and be prompted for:
PROMPT INPUT
__________
____________________________________________________
START @: STARTING SECTOR (DEC)
XFER CT: # OF SECTORS TO READ IN (0 WILL ABORT)
BUFF ST: STARTING BYTE IN BUFFER TO START TRANSFER
You will be shown the bytes/sector and then "<R>ead" will appear. You
must depress either 'r' or 'R' to initiate the read operation. Any
other key will abort this option. As the sectors are reading in, you
will see the count of that sector displayed (if the number of sectors
are small, this might occur to fast to see). The current window view
will be updated when this is done!
ZZAP (c) 1987 David K. Lovison 17 WESTCOMP
8.0 .... OPEN A WINDOW VIEW
Two window views can be opened at any one time. Only one of the two
may be active. The active window is the one with the high-lighted
window border. Remember that you can change the active window at the
top level by using the F1 / F2 keys. If you try to open a third
window, you will get an error message telling you to remove a window
view first. Remember that the 'ESC' key will delete the current
(active) window.
When a window view is opened, the mode will be set to whatever was
last selected. What the window view will be a window into depends on
what the bottom status line is showing. (BUF: BUF) will set the view
to the internal dedicated window view buffer. (BUF: MEM / SEG:
0x????) will set the view to the segment specified by ????. Whatever
it is a view into, the full range of the window view is 0 - 65535, for
a total of 65536 bytes (1 full segment size).
Also remember that when the term buffer is used for the access mode in
the page operations, it is refering to the CURRENT WINDOW VIEW and
whatever it is viewing. It could be viewing the dedicated file buffer
for the page mode by entering that buffer segment in the 'c' operation
(from top level).
ZZAP (c) 1987 David K. Lovison 18 WESTCOMP
9.0 .... DISK OUTPUT FROM A WINDOW VIEW
You may write file or sector data into the current window view. Pay
attention to what the current window view is pointing to! If the
drive you are using is a removeable media drive, be sure the media is
in first and NOT write protected!!!
NOTE: ZZAP RETAINED THE FATAL ERROR HANDLER OF MS-DOS. IF A FATAL ERROR
DOES OCCUR, ATTEMPT TO CORRECT THE PROBLEM (UNLESS YOU WANT TO ABORT)
AND RETRY THE OPERATION. THE WORST CASE RESULT IS THAT SMALL PORTIONS
OF THE SCREEN WILL RETAIN THE CHARACTORS THAT WERE PRINTED BY THE
FATAL ERROR ROUTINE. IT WAS DECIDED THAT IF THE ERROR WAS FATAL IN
NATURE, WE WANTED ZZAP TO RETURN TO THE OPERATING SYSTEM IN CASE OF
AN EMERGENCY ABORT.
Upon selection of this option, you will be prompted with a window
menu:
1 - FILE ACCESS
2 - SECTOR ACCESS
7.1 .... FILE ACCESS
DO NOT REMOVE YOUR DISK MEDIA UNTIL THE PROGRAM HAS RETURNED TO THE
TOP LEVEL!
You will be shown the drive/path/filename (same one as in PAGE
OPERATIONS) and be given an opportunity to change it.
After depressing the "ENTER" key, the file will be accessed and the
size of file will be displayed.
PROMPT INPUT
__________ ____________________________________________________
FILE ST: >= 1, 0 WILL ABORT, ERROR IF > SIZE OF FILE
XFER CT: NUMBER OF BYTES TO TRANSFER TO THE CURRENT WINDOW
BUFF ST: STARTING BYTE OF BUFFER TO BEGIN THE TRANSFER
An error will result if the XFER CT plus the BUFF ST exceeds the end
of the window view buffer (65535). The maximum bytes that can be
transfered is 65536 when BUFF ST = 0. If the XFER CT is greater than
the end of the file, the size of the file will be increased. Keep in
mind that this is done by stream operations, so any END-OF-FILE
indicator may be overwritten! If you need a particular indicator, you
can easily write that out to the end of the file with ZZAP. Writes
that are less that the size of file will not reduce the size of the
file. The data is "painted" where you want it on the file.
After entering the above, "<W>rite" will appear. You must enter an
'w' or 'W' to begin the write operation. After the write is done, you
will be told the number of bytes that actually transfered and ZZAP
will pause until you depress a key.
ZZAP (c) 1987 David K. Lovison 19 WESTCOMP
The current window is updated upon return to the top level.
7.2 .... SECTOR ACCESS
You will be shown the drive (change it in the PAGE OPERATIONS options)
and be prompted for:
PROMPT INPUT
__________
____________________________________________________
START @: STARTING SECTOR (DEC)
XFER CT: # OF SECTORS TO WRITE (0 WILL ABORT)
BUFF ST: STARTING BYTE IN BUFFER TO START TRANSFER
You will be shown the bytes/sector and then "<W>rite" will appear.
You must depress either 'w' or 'W' to initiate the write operation.
Any other key will abort this option. As the sectors are being
written, you will see the count of that sector displayed (if the
number of sectors are small, this might occur to fast to see). The
current window view will be updated when this is done!
ZZAP (c) 1987 David K. Lovison 20 WESTCOMP
10.0 .... WINDOW VIEW BUFFER <-> MEMORY TRANSFERS
This is to transfer between the dedicated window view buffer and
memory. Upon selection of this option, a window with two (2) options
will appear:
1 - MEMORY -> BUFFER
2 - BUFFER -> MEMORY
Chose the direction you want the transfer to go. <M> will move memory
into the buffer (the dedicated window view buffer). <B> will move
data in the buffer to the specified memory location.
After selection of the direction, answer the following prompts:
PROMPT INPUT
__________ ____________________________________________________
MEM (HEX) SEG: INPUT THE MEMORY SEGMENT IN HEX
MEM BYTE: SEGMENT OFFSET (DEC) 0 - 65535
BUFFER ST: STARTING BYTE OF THE DEDICATED WINDOW BUFFER TO XFER
# BYTES: NUMBER OF BYTES TO TRANSFER
( IF 0, ABORT)
( IF BUFFER ST + # BYTES > END OF BUFFER, ERROR)
( IF NO VALUE ENTERED, ABORT)
If there is a current window up, the top of that window is set to the
value entered as the BUFFER ST value and the window is updated (it is
possible that the current window is not pointing to the dedicated
window buffer, in which case the update would only remind you what the
buffer start byte was).
It is not required to even have a window view open to perform this
operation, since the buffer used is always the dedicated window view
buffer.
ZZAP (c) 1987 David K. Lovison 21 WESTCOMP
11.0 .... LEAVING ZZAP
It is easy (perhaps too much so) to exit ZZAP. Just depressing an
upper or lower case Z will return you back to the command line of MS-
DOS. Don't make a practice of leaning your hands or anything else on
the keyboard - you might exit at a time you did not want to!
If you find a change you would like to see to ZZAP or a bug (hope
not!), please let us know by a letter with the exact information -
please print! If you are the first to make us aware of a problem or
we include an enhancement that you first suggested, we will send you
the updated version with our thanks!
We keep a data base of those that have purchased ZZAP. This data base
will be used to make all aware of major changes and how to aquire
them.
IF YOU PURCHASED ZZAP, THANK YOU. IF YOU HAVE A COPY AND HAVE NOT
PAID, PLEASE SEND IN YOUR PAYMENT FOR A MODEST $30.00. WE AND OTHERS
LIKE US CAN ONLY SURVIVE IF SUCH QUALITY, LOW PRICED SOFTWARE IS
PROPERLY PAID FOR. PROGRAMS THAT DO HALF OF WHAT ZZAP DOES WILL COST
YOU MUCH MORE IF PURCHASED IN ONE OF THE NORMAL STORES, ETC.
AGAIN, THANKS.